Converts any lowercase characters in a text string into their uppercase equivalents and strips any diacritical marks from the text.

void UppercaseStripDiacritics (
    Ptr textPtr, 
    SInt16 len, 
    ScriptCode script
);

Parameter descriptions

textPtr

A pointer to the text string to be converted.

len

The length, in bytes, of the text string. The text string can be up to 32 KB in length.

script

The script code of the script system whose resources are used to determine the results of converting characters.

The conversion uses tables in the string-manipulation ('itl2') resource of the script specified by the value of the script parameter. You can specify smSystemScript to use the system script and smCurrentScript to use the script of the current font in the current graphics port.

DISCUSSION

UppercaseStripDiacritics traverses the characters starting at the address specified by textPtr and continues for the number of characters specified in len. It converts lowercase characters in the text into their uppercase equivalents and also strips diacritical marks from the text string. This function combines the effects of the UppercaseText and StripDiacritics functions.

If UppercaseStripDiacritics cannot access the specified resource, it generates an error code and does not modify the string. You need to call the ResError function to determine which, if any, error occurred.

SPECIAL CONSIDERATIONS

UppercaseStripDiacritics may move memory; your application should not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)